Skip to content

Update macOS Homebrew install docs for formula-to-cask migration - #6109

Open
Mike F. Robbins (mikefrobbins) wants to merge 1 commit into
MicrosoftDocs:mainfrom
mikefrobbins:mr-azcli-607191
Open

Update macOS Homebrew install docs for formula-to-cask migration#6109
Mike F. Robbins (mikefrobbins) wants to merge 1 commit into
MicrosoftDocs:mainfrom
mikefrobbins:mr-azcli-607191

Conversation

@mikefrobbins

@mikefrobbins Mike F. Robbins (mikefrobbins) commented Aug 6, 2026

Copy link
Copy Markdown
Collaborator

PR Summary

This PR updates the macOS Homebrew install documentation for the Azure CLI formula-to-cask migration (scheduled Aug 10-11). It adds both install commands, a migration note, troubleshooting guidance, and removes the now-obsolete preview macOS install article.

Changes

  • install-azure-cli-macos.md - Added migration note, both install commands, and troubleshooting section for formula-to-cask transition
  • install-azure-cli-macos-preview.md - Deleted (redirected to install-azure-cli-macos)
  • install-azure-cli.md - Removed preview macOS link
  • index.yml - Removed preview macOS card
  • toc.yml - Removed preview macOS entry
  • .openpublishing.redirection.json - Added redirect for deleted preview article

PR Checklist

  • Descriptive Title: This PR's title is a synopsis of the changes it proposes.
  • Summary: This PR's summary describes the scope and intent of the change.

Related work items

  • AB#607191 - Update macOS Homebrew install docs for formula-to-cask migration
  • AB#607192 - Update install commands to show both brew install azure-cli and brew install --cask azure-cli
  • AB#607193 - Add note explaining homebrew-core to homebrew-cask migration
  • AB#607194 - Add troubleshooting section for formula-to-cask transition issues
  • AB#607195 - Create draft PR for macOS Homebrew install doc updates

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@mikefrobbins
Mike F. Robbins (mikefrobbins) marked this pull request as ready for review August 6, 2026 19:00
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit dcfaa30:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/Latest-version/index.yml ✅Succeeded View (azure-cli-latest)
docs-ref-conceptual/Latest-version/install-azure-cli-macos-preview.md ✅Succeeded n/a (file deleted or renamed)
docs-ref-conceptual/Latest-version/install-azure-cli-macos.md ✅Succeeded View (azure-cli-latest)
docs-ref-conceptual/Latest-version/install-azure-cli.md ✅Succeeded View (azure-cli-latest)
docs-ref-conceptual/Latest-version/toc.yml ✅Succeeded View (azure-cli-latest)
openpublishing-redirection-config/.openpublishing.redirection.json ✅Succeeded View (azure-cli-latest)

For more details, please refer to the build report.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants